home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 026a / screen.zip / README.SCR next >
Text File  |  1990-08-18  |  7KB  |  243 lines
  1.             Screen.BIN
  2.  
  3.     Copyright (C) Paul B. Powers, August 18, 1990
  4.  
  5.     When distributing the screen.bin file this text file,
  6. readme.scr is to be distributed along with it.  This software is
  7. being distributed as Freeware and no payment is charged for its
  8. use or distribution.  The author has made every available attempt
  9. to test this piece of software.  However, the author cannot be
  10. held responsible for any damage, loss or other mishaps as a
  11. result of the usage of this software.
  12.  
  13.  
  14. The bin file takes two parameters.  the bin file can be called
  15. with the call command or function - Call or Call() as follows;
  16.  
  17.     load screen
  18.  
  19.     * either *
  20.     call screen with <parameter1>, <parameter2>
  21.     * or     *
  22.     memvar = call("screen","<parameter1>,"<parameter2>")
  23.  
  24.     release module screen
  25.  
  26.     parameter1 has the following option;
  27.     "W" or "w" - which will write the screen characters and
  28.                 attributes to the filename specified in
  29.                 parameter2.  Neither write mode will 
  30.                 overwrite a file.
  31.  
  32.     "W-" or "w-" - which will write only the screen characters
  33.                 to the file spoecified in parameter2. Neither
  34.                 write mode will overwrite a file.
  35.  
  36.     "A" or "a" - which will only append the screen characters to
  37.                 the filename specified in parameter2.  The
  38.                 append mode will only concatenate the
  39.                 characters to the end of the file specified
  40.                 in parameter2.
  41.  
  42.     "R" or "r" - which will read the file and print it on the
  43.                 screen, whether the bin file prints only
  44.                 characters or both characters and color
  45.                 attributes depends on the size of the source
  46.                 file to be read (see chart below).
  47.                 specified by
  48.  
  49.     parameter 2 is the drive:\path\filename of the file that is
  50. to be read, written, or appended.
  51.  
  52.  
  53.     You can also use a text editor to make the text file to be
  54. read in.  To do this make sure you use only spaces, don't use any
  55. tabs to fill in blank spaces.  Each row on the screen is expected
  56. to be 81 characters long.  The first 80 characters are expected
  57. to be text characters (i.e. no tabs, use the spacebar to create
  58. blank spaces), on column 81 you are expected to press the enter
  59. key.  If you are in a 25-line mode (Mono, CGA, EGA or VGA) make
  60. sure the text file has 25 lines.  If you are in a 43-line mode
  61. (EGA) or a 50-line mode (VGA) make sure the text file has 43 or
  62. 50 lines in it, respectively.  This file format is designed so
  63. that a text editor will be to read a text file that is created by
  64. screen.bin with the "w-" or the "a" option.  To see the type of
  65. file screen.bin creates creates in general see the diagram below.
  66.  
  67.  
  68.  
  69.  
  70.  
  71. For writing your own text files to use with screen.bin the format
  72. is as follows:
  73.  
  74.             text file
  75. 1                                            80  81
  76. |------------------------------------------------------|<cr>/<lf>
  77. |                                            |
  78. |                                            |
  79. |        characters go here                        |
  80. |                                            |
  81. |                                            |
  82. |------------------------------------------------------|
  83. |                                            |
  84. |                                            |
  85. |        (optional) attributes go here,            |
  86. |    not used with the "w-" and "a" modes            |
  87. |                                            |
  88. |------------------------------------------------------|
  89.  
  90. The "r" option will read in and interpret the file as having
  91. characters only or having both characters and color attributes
  92. based on the size of the specified text file.  The interpretation
  93. will be based as follows:
  94.  
  95.  
  96. 25-line mode  4098 bytes: (82 bytes/row) * (25 rows) * 2 (for 
  97.             and above        character and color attributes). 
  98.                         Why 82 bytes/row instead of 81 is
  99.                         that a text  editor will place two
  100.                         characters (a <cr> and a <lf>) in
  101.                         the file when the [enter] key is
  102.                         pressed.  This resultant size will
  103.                         actually work out to be 4101
  104.                         bytes.  Three bytes are taken off
  105.                         the file size in case the last
  106.                         <cr>/<lf> and the end-of-file
  107.                         marker is not added on.
  108.  
  109.             2048 to    : (82 bytes/row) * (25 rows). Only     
  110.             4097 bytes    characters will be read from        
  111.                         the specified text file.
  112.  
  113.  
  114.  
  115. 43-line mode    7050 bytes: (82 bytes/row) * (43 rows) * 2  Both
  116.             and above        characters and color attributes
  117.                         will be read from the specified
  118.                         text file.
  119.  
  120.             3524 to    : (82 bytes/row) * (43 rows).  Only     
  121.             7049 bytes    characters will be read from the     
  122.                         specified text file.
  123.  
  124.  
  125.  
  126. 50-line mode    8198 bytes: (82 bytes/row) * (50 rows) * 2.  Both
  127.             and above        character and color attributes will
  128.                         be read from the specified text
  129.                         file.
  130.  
  131.             4098 to    : (82 bytes/row) * (50 rows).  Only
  132.             8197 bytes    characters will be read from the
  133.                         specified text file.
  134.  
  135.  
  136.  
  137. Since some people have a "beta" version of this bin file a
  138. listing of the changes and fixes have been provided.
  139.  
  140. Version 1.1b - Changes and Fixes.
  141.  
  142. 1. Bug fix regarding reading the color attributes.  Reading in a
  143. file
  144.    with color attributes to write to the screen resulted in the
  145. color
  146.    attributes being read in, but shifted one column to the left
  147. on the
  148.    screen.  The text would appear normal on the screen but it's
  149. color
  150.    attribute would appear column to the left of the text.  This
  151. bug
  152.    has been fixed.
  153.  
  154. 2. At the DOS-prompt type "type screen.bin" to see the version
  155. number-
  156.    thanks goes to Keith Mund for presenting this idea to me.
  157.  
  158.  
  159. Version 1.2 - Changes.
  160.  
  161. 1. Screen.bin can now be called with the call() function, and
  162. will
  163.    pass back an error/success code to dBASE IV.  The error codes
  164. are
  165.    assigned as follows;
  166.  
  167.    1: Product is not dBASE IV (you should never see this error
  168. code,
  169.      let me know if you do).
  170.  
  171.    2: Lines on screen are not set to 25, 43, or 50.
  172.  
  173.    3: First parameter was not a "W","w","R","r","A", or an "a".
  174.  
  175.    4: Unable to open file, the file does not exist, was
  176. previously
  177.      opened or the path was mispelled .
  178.  
  179.    5: File is too small to read, for the current line mode.
  180.  
  181.    6: Unable to position a file pointer for a file read.
  182.  
  183.    7: Error occured during a file read.
  184.  
  185.    8: file already exists (happens with the "W","W-","w" or "w-"
  186.      option).
  187.  
  188.    9: Unable to create the file (happens with the
  189. "W","W-","w","w-"
  190.      and the "A" and "a" options).
  191.  
  192.    A: Unable to position a file pointer for a file write.
  193.  
  194.    B: Error occured during a file write.
  195.  
  196.    C: File failed to close.
  197.  
  198. Version 1.2b - Fixes
  199.  
  200. 1. Minor corrective coding change provided to ensure proper
  201. embedding of carriage return/linefeeds and end of file markers in
  202. the output file.
  203.  
  204. Version 1.2c - Changes
  205.  
  206. 1. Just a change in what the copyright says when a "type
  207. screen.bin" writes when executed from a dos-prompt.  Nothing else
  208. has changed.
  209.  
  210.  
  211.  
  212. Further Enhancements:
  213.  
  214.   If you like this piece of software or think it could be
  215. enhanced in a certain fashion please contact him.  Any further
  216. advancement of this bin file will be proportional to it's use AND
  217. the response for enhancement of those who use it.
  218.  
  219. The author can be contacted by E-mail on the Ashton Tate BBS at;
  220.  
  221.     1200 BAUD  (213)538-6196
  222.  
  223.     2400 BAUD  (213)324-2188
  224.  
  225.     or on Compuserv (for free access use this route), 
  226.     at the "Host Name:" prompt type "ATBBS"
  227.     
  228.  
  229.     Please leave E-mail for the user name of Plpowers.
  230.  
  231.  
  232. Special thanks goes to those who were part of the beta-testing on
  233. this bin file, they are;
  234.  
  235. Judy Maske
  236. Dan Madoni
  237. Roger Bowman
  238.  
  239. Thanks very much guys !
  240.  
  241.  
  242. And lastly thank you very much, and enjoy !
  243.